Node / meshtastic / Meshtastic-Android / files / core / network / src / commonMain / kotlin / org / meshtastic / core / network / service / ApiService.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.core.network.service

Tff7b72import T7ee787io.ktor.client.HttpClient

Tff7b72import T7ee787io.ktor.client.call.body

Tff7b72import T7ee787io.ktor.client.request.get

Tff7b72import T7ee787io.ktor.client.statement.bodyAsText

Tff7b72import T7ee787io.ktor.http.HttpStatusCode

Tff7b72import T7ee787io.ktor.http.isSuccess

Tff7b72import T7ee787kotlinx.serialization.json.Json

Tff7b72import T7ee787org.koin.core.annotation.Single

Tff7b72import T7ee787org.meshtastic.core.model.EventFirmwareResponse

Tff7b72import T7ee787org.meshtastic.core.model.FirmwareReleaseManifest

Tff7b72import T7ee787org.meshtastic.core.model.NetworkDeviceHardware

Tff7b72import T7ee787org.meshtastic.core.model.NetworkDeviceLinksResponse

Tff7b72import T7ee787org.meshtastic.core.model.NetworkFirmwareNightly

Tff7b72import T7ee787org.meshtastic.core.model.NetworkFirmwareReleases

T8b949e/**

* Pointer to the nightly preview build published by CI to meshtastic.github.io. Served from GitHub Pages raw content

* (not api.meshtastic.org) as `text/plain`, so it is parsed manually rather than via content negotiation.

*/

Tff7b72private Tff7b72const Tff7b72val Te6edf3NIGHTLY_INDEX_URL Tff7b72=

Ta5d6ff"Ta5d6ffhttps://raw.githubusercontent.com/meshtastic/meshtastic.github.io/master/firmware-nightly/index.jsonTa5d6ff"

Tff7b72private Tff7b72val Te6edf3firmwareJson Tff7b72= Te6edf3Json Tb4b4b4{

Te6edf3isLenient Tff7b72= Tff7b72true

Te6edf3ignoreUnknownKeys Tff7b72= Tff7b72true

Te6edf3coerceInputValues Tff7b72= Tff7b72true

Tb4b4b4}

T8b949e/**

* Decodes a GitHub release manifest independently of Ktor content negotiation. GitHub release assets commonly use

* `application/octet-stream` even when their payload is JSON.

*/

Tff7b72internal Tff7b72fun Td2a8ffdecodeFirmwareReleaseManifestTb4b4b4(Te6edf3bodyTb4b4b4: Tffa657StringTb4b4b4)Tb4b4b4: Te6edf3FirmwareReleaseManifest Tff7b72= Te6edf3firmwareJsonTb4b4b4.Te6edf3decodeFromStringTb4b4b4(Te6edf3bodyTb4b4b4)

T8b949e/** Client for the Meshtastic public API (device hardware catalog and firmware releases). */

Tff7b72interface T56d364ApiService Tb4b4b4{

T8b949e/** Fetches the device hardware catalog from the Meshtastic API. */

Tff7b72suspend Tff7b72fun Td2a8ffgetDeviceHardwareTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3ListTff7b72<Te6edf3NetworkDeviceHardwareTff7b72>

T8b949e/** Fetches the resolved device-links catalog (msh.to purchase links) from the Meshtastic API. */

Tff7b72suspend Tff7b72fun Td2a8ffgetDeviceLinksTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3NetworkDeviceLinksResponse

T8b949e/** Fetches the list of available firmware releases from the Meshtastic API. */

Tff7b72suspend Tff7b72fun Td2a8ffgetFirmwareReleasesTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3NetworkFirmwareReleases

T8b949e/** Fetches the target manifest referenced by a firmware release's `zip_url`. */

Tff7b72suspend Tff7b72fun Td2a8ffgetFirmwareReleaseManifestTb4b4b4(Te6edf3manifestUrlTb4b4b4: Tffa657StringTb4b4b4)Tb4b4b4: Te6edf3FirmwareReleaseManifest

T8b949e/**

* Fetches the nightly preview build pointer from meshtastic.github.io. Returns null when no nightly is currently

* published (HTTP 404); throws on transport or server errors so callers can distinguish "gone" from "unreachable".

*/

Tff7b72suspend Tff7b72fun Td2a8ffgetNightlyFirmwareTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3NetworkFirmwareNightly?

T8b949e/** Fetches event-firmware display metadata (editions, welcome messages, links) from the Meshtastic API. */

Tff7b72suspend Tff7b72fun Td2a8ffgetEventFirmwareTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3EventFirmwareResponse

Tb4b4b4}

T8b949e/**

* Ktor-based [ApiService] implementation.

*

* Uses relative paths — the base URL is set via the `DefaultRequest` plugin in the platform Koin modules.

*

* Registered with `binds = []` to prevent Koin from auto-binding to [ApiService]; host modules (`app`, `desktop`)

* provide their own explicit `ApiService` binding to allow platform-specific `HttpClient` engines.

*/

Tf0883e@SingleTb4b4b4(Te6edf3binds Tff7b72= Tff7b72[Tff7b72]Tb4b4b4)

Tff7b72class T56d364ApiServiceImplTb4b4b4(Tff7b72private Tff7b72val Te6edf3clientTb4b4b4: Te6edf3HttpClientTb4b4b4) Tb4b4b4: Te6edf3ApiService Tb4b4b4{

Tff7b72override Tff7b72suspend Tff7b72fun Td2a8ffgetDeviceHardwareTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3ListTff7b72<Te6edf3NetworkDeviceHardwareTff7b72> Tff7b72= Te6edf3clientTb4b4b4.Te6edf3getTb4b4b4(Ta5d6ff"Ta5d6ffresource/deviceHardwareTa5d6ff"Tb4b4b4)Tb4b4b4.Te6edf3bodyTb4b4b4(Tb4b4b4)

Tff7b72override Tff7b72suspend Tff7b72fun Td2a8ffgetDeviceLinksTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3NetworkDeviceLinksResponse Tff7b72= Te6edf3clientTb4b4b4.Te6edf3getTb4b4b4(Ta5d6ff"Ta5d6ffresource/deviceLinksTa5d6ff"Tb4b4b4)Tb4b4b4.Te6edf3bodyTb4b4b4(Tb4b4b4)

Tff7b72override Tff7b72suspend Tff7b72fun Td2a8ffgetFirmwareReleasesTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3NetworkFirmwareReleases Tff7b72= Te6edf3clientTb4b4b4.Te6edf3getTb4b4b4(Ta5d6ff"Ta5d6ffgithub/firmware/listTa5d6ff"Tb4b4b4)Tb4b4b4.Te6edf3bodyTb4b4b4(Tb4b4b4)

Tff7b72override Tff7b72suspend Tff7b72fun Td2a8ffgetFirmwareReleaseManifestTb4b4b4(Te6edf3manifestUrlTb4b4b4: Tffa657StringTb4b4b4)Tb4b4b4: Te6edf3FirmwareReleaseManifest Tff7b72=

Te6edf3decodeFirmwareReleaseManifestTb4b4b4(Te6edf3clientTb4b4b4.Te6edf3getTb4b4b4(Te6edf3manifestUrlTb4b4b4)Tb4b4b4.Te6edf3bodyAsTextTb4b4b4(Tb4b4b4)Tb4b4b4)

Tff7b72override Tff7b72suspend Tff7b72fun Td2a8ffgetNightlyFirmwareTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3NetworkFirmwareNightly? Tb4b4b4{

Tff7b72val Te6edf3response Tff7b72= Te6edf3clientTb4b4b4.Te6edf3getTb4b4b4(Te6edf3NIGHTLY_INDEX_URLTb4b4b4)

Tff7b72return Tff7b72when Tb4b4b4{

Te6edf3responseTb4b4b4.Te6edf3status Tff7b72=Tff7b72= Te6edf3HttpStatusCodeTb4b4b4.Te6edf3NotFound Tff7b72-Tff7b72> Tff7b72null

Te6edf3responseTb4b4b4.Te6edf3statusTb4b4b4.Te6edf3isSuccessTb4b4b4(Tb4b4b4) Tff7b72-Tff7b72> Te6edf3firmwareJsonTb4b4b4.Te6edf3decodeFromStringTff7b72<Te6edf3NetworkFirmwareNightlyTff7b72>Tb4b4b4(Te6edf3responseTb4b4b4.Te6edf3bodyAsTextTb4b4b4(Tb4b4b4)Tb4b4b4)

Tff7b72else Tff7b72-Tff7b72> Te6edf3errorTb4b4b4(Ta5d6ff"Ta5d6ffUnexpected HTTP Tffd700${Te6edf3responseTb4b4b4.Te6edf3statusTffd700}Ta5d6ff fetching nightly firmware indexTa5d6ff"Tb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tff7b72override Tff7b72suspend Tff7b72fun Td2a8ffgetEventFirmwareTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3EventFirmwareResponse Tff7b72= Te6edf3clientTb4b4b4.Te6edf3getTb4b4b4(Ta5d6ff"Ta5d6ffresource/eventFirmwareTa5d6ff"Tb4b4b4)Tb4b4b4.Te6edf3bodyTb4b4b4(Tb4b4b4)

Tb4b4b4}